home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / pcfrm621.zip / PCFORMS.DOC < prev    next >
Text File  |  1993-01-04  |  53KB  |  1,616 lines

  1.  
  2.  
  3.  
  4.             
  5.             
  6.             
  7.             
  8.             
  9.                                           
  10.                                -  P C - F O R M S  -
  11.             
  12.                               DOCUMENT ASSEMBLY SYSTEM
  13.             
  14.             
  15.             
  16.             
  17.             
  18.             
  19.             
  20.             
  21.             
  22.                            (The Electronic Forms Library)
  23.             
  24.             
  25.             
  26.             
  27.                                    USERS' MANUAL
  28.                                           
  29.                                       for the
  30.             
  31.                                   PC-FORMS PROGRAM
  32.             
  33.             
  34.             
  35.             
  36.             
  37.             
  38.             
  39.             
  40.             
  41.                                  Copyright 1990-91
  42.                                William W. Blackledge
  43.                                 3704 Edgewater Drive
  44.                               Oklahoma City, Oklahoma
  45.                                        73116
  46.                                    (405) 840-3563
  47.             
  48.             
  49.                                    _______ 
  50.                               ____|__     |               (R)
  51.                            --|       |    |-------------------
  52.                              |   ____|__  |  Association of
  53.                              |  |       |_|  Shareware
  54.                              |__|   o   |    Professionals
  55.                            -----|   |   |---------------------
  56.                                 |___|___|    MEMBER
  57.             
  58.             
  59.  
  60.  
  61.             
  62.             
  63.             
  64.             
  65.             
  66.             
  67.             
  68.                        *********************************
  69.                        **     TABLE OF CONTENTS       **
  70.                        *********************************
  71.                                        
  72.                        Overview . . . . . . . . . . .  1
  73.             
  74.                        Summary of PC-FORMS' Features . 2
  75.             
  76.                        PC-FORMS Startup  . . . . . . . 6
  77.             
  78.                        PC-FORMS Master Menu  . . . . . 8
  79.             
  80.                        Text Menu  . . . . . . . . . . 10
  81.             
  82.                        Variable Input Screen . . . .  11
  83.             
  84.                        Revised Text Screen . . . . .  13
  85.             
  86.                        Output Modes . . . . . . . . . 14
  87.             
  88.                        Variable Files . . . . . . . . 15
  89.             
  90.                        Color and Value Billing Codes. 16
  91.             
  92.                        Source Text Rules  . . . . . . 17
  93.             
  94.                        PC-LIBRARY Program . . . . . . 21
  95.             
  96.                        *********************************
  97.             
  98.             
  99.             
  100.             
  101.             
  102.             
  103.             
  104.             WordStar is a trademark of WordStar International Inc.
  105.             WordPerfect is a trademark of WordPerfect Corporation.
  106.             PC-Write is a trademark of Quicksoft.
  107.             FriendlyWriter is a trademark of Friendly Soft Inc. 
  108.             
  109.                                Copyright 1990-91
  110.                              William W. Blackledge
  111.                              3704 Edgewater Drive
  112.                             Oklahoma City, Oklahoma
  113.                                      73116
  114.                                 (405) 840-3563
  115.             
  116.  
  117.  
  118.                                PC-FORMS USERS' MANUAL
  119.             
  120.             
  121.             
  122.                                       OVERVIEW
  123.             
  124.             The PC-FORMS document assembly system consists of two pro-
  125.             
  126.             grams, PC-FORMS and PC-LIBRARY, which automate the assembly 
  127.             
  128.             of legal and business documents.  They permit use of the 
  129.             
  130.             user's choice of words in computer-prepared documents.
  131.             
  132.             
  133.             
  134.             The PC-FORMS program, PCFM.EXE, lets the user select from a 
  135.             
  136.             forms library furnished with the programs, or prepared by 
  137.             
  138.             the user, text to be included in a particular document.  If 
  139.             
  140.             the selected text contains variable names, the user is 
  141.             
  142.             prompted for language to be inserted in lieu of those names.  
  143.             
  144.             After all variable prompts are answered the text is revised 
  145.             
  146.             and displayed for acceptance or rejection.
  147.             
  148.             
  149.             
  150.             PC-FORMS eliminates repeated proof-reading of "boiler-plate" 
  151.             
  152.             text.  Variable information that does change is typed and 
  153.             
  154.             proofed only once, even if used repeatedly in a document.  
  155.             
  156.             The documents can be modified with a word processor for 
  157.             
  158.             unusual situations.  The programs may be linked to WordStar, 
  159.             
  160.             WordPerfect, Microsoft Word, VDE, PC-Write, Friendly-Writer 
  161.             
  162.             or other word processing programs.  When linked, completed 
  163.             
  164.             documents are automatically loaded by PC-FORMS into the 
  165.             
  166.             user's word processor.
  167.             
  168.             
  169.             
  170.             As a document is prepared the program accumulates the re-
  171.             
  172.             vised text in a document file.  It also accumulates, in 
  173.  
  174.  
  175.                                        - 1 -
  176.  
  177.  
  178.             
  179.             another file, the variable responses entered and a record of 
  180.             
  181.             the text selections made.  This file may be used to "proof" 
  182.             
  183.             the completed document or as a record of its contents.
  184.             
  185.             
  186.             
  187.             The PC-LIBRARY program is a companion program to the PC-
  188.             
  189.             FORMS program.  It assists the user in creating and main-
  190.             
  191.             taining Forms Libraries for the system.  There is a separate 
  192.             
  193.             manual which explains the operation of that program.  After 
  194.             
  195.             sections of text have been entered into a set of library 
  196.             
  197.             files, PC-LIBRARY will prompt the user to enter a prompt for 
  198.             
  199.             each variable name included in that text for which no prompt 
  200.             
  201.             exists in the library variable file and will arrange the 
  202.             
  203.             text headings in numerical and alphabetical sequence for the 
  204.             
  205.             text selection indexes.
  206.             
  207.             
  208.             
  209.             The form library files (with suffixes of .VBL and .LEX) must 
  210.             
  211.             be in the current working file directory.  The program files 
  212.             
  213.             (with the .EXE suffix) and the FMHELP.MSG file may be in the 
  214.             
  215.             same directory or any other directory included in the DOS 
  216.             
  217.             "PATH" command.  If the PCFM.EXE program is run from the 
  218.             
  219.             same directory as WordStar, WordPerfect, Microsoft Word, 
  220.             
  221.             VDE, PC-Write, or FriendlyWriter, it will automatically link 
  222.             
  223.             to the word processing program or it can be linked using the 
  224.             
  225.             Setup Menu.  The program to convert from WordStar 3.3 must 
  226.             
  227.             be in the same directory, for WordPerfect - CONVERT.EXE; for 
  228.             
  229.             Microsoft Word - WS_RTF.EXE and for FriendlyWriter - 
  230.             
  231.             FWCNV.EXE.
  232.             
  233.  
  234.  
  235.                                        - 2 -
  236.  
  237.  
  238.                            SUMMARY OF PC-FORMS' FEATURES
  239.             
  240.             PC-FORMS is started by entering the command "PCFM" at the 
  241.             
  242.             DOS prompt.  The opening screen displays a list of the forms 
  243.             
  244.             libraries available in the current directory.  The user is 
  245.             
  246.             asked to enter a form name or, if help is desired, a ques-
  247.             
  248.             tion mark.
  249.             
  250.             
  251.             
  252.             Entering a question mark displays a description of the PC-
  253.             
  254.             FORMS System programs and forms libraries.  The user can 
  255.             
  256.             scroll through this text using the up and down arrow keys 
  257.             
  258.             and the <Page-Up>, <Page-Down>, <Home> and <End> keys.  The 
  259.             
  260.             <Escape> key is used to exit the help screen.
  261.             
  262.             
  263.             
  264.             After entering a form name, the user is prompted to enter a 
  265.             
  266.             filename for the document to be assembled.  This is a stand-
  267.             
  268.             ard DOS filename of 8 or less characters, a dot, and a 
  269.             
  270.             suffix of 3 or less characters, such as "JOHNSON.WIL".  The 
  271.             
  272.             filename may be preceded by a directory path such as 
  273.             
  274.             "C:\MYDOCS\JOHNSON.WIL" if the user wants it to be stored in 
  275.             
  276.             a specified directory.
  277.             
  278.             
  279.             
  280.             If the filename of a previous document is entered PC-FORMS 
  281.             
  282.             informs the user that the file exists and asks whether to 
  283.             
  284.             overwrite it or append to it.  If neither option is selected 
  285.             
  286.             the user may enter a new filename.
  287.             
  288.             
  289.             
  290.             A proof file is created for each document assembled using 
  291.             
  292.             PC-FORMS.  If there are any proof files for the form library 
  293.  
  294.  
  295.                                        - 3 -
  296.  
  297.  
  298.             
  299.             selected by the user, the program asks the user if he, or 
  300.             
  301.             she, desires to load the responses from the proof file of a 
  302.             
  303.             previous document.  This feature makes it unnecessary to re-
  304.             
  305.             enter responses for a series of documents for which variable 
  306.             
  307.             responses will not change.
  308.             
  309.             
  310.             
  311.             If the user desires to load the variable responses from a 
  312.             
  313.             proof file, the program displays a list of all previous 
  314.             
  315.             proof files for the selected forms library and requests the 
  316.             
  317.             entry of the one from which to load responses.
  318.             
  319.             
  320.             
  321.             When these preliminary entries are completed, the first of 4 
  322.             
  323.             menu screens used to assemble documents is displayed.  These 
  324.             
  325.             screens are:
  326.             
  327.                     1 - The MASTER MENU screen,
  328.             
  329.                     2 - The TEXT SELECTION screen,
  330.             
  331.                     3 - The VARIABLE INPUT screen, and
  332.             
  333.                     4 - The REVISED TEXT screen.
  334.             
  335.             
  336.             There are 9 selections on the MASTER MENU screen which are 
  337.             
  338.             selected by entering the corresponding numeral.
  339.             
  340.             
  341.                     1.  Text Menu (to Start or Continue a Document)
  342.                     2.  Help, Order or Setup Menu
  343.                     3.  Text Selection Indexes (to Find Text)
  344.                     4.  Go to a Text Menu (to Skip to a Menu)
  345.                     5.  Display Document (to View the Document)
  346.                     6.  Line Spacing Toggle = SINGLE
  347.                     7.  Change from <FORMNAME> to Another Library  
  348.                     8.  Quit - Exit Unfinished Document
  349.                     9.  Quit - Exit to Word Processor
  350.             
  351.  
  352.  
  353.  
  354.  
  355.                                        - 4 -
  356.  
  357.  
  358.             Text selections may be made from the current Text Menu or 
  359.             
  360.             from the Text Selection Indexes.  Indexes of text selections 
  361.             
  362.             are displayed in both numeric and alphabetical sequence.  
  363.             
  364.             The numeric sequence is in logical sequence for document 
  365.             
  366.             preparation except that some document headings and closings 
  367.             
  368.             may be at the beginning or end of a forms library.
  369.             
  370.             
  371.             
  372.             Each text-entry screen displays a highlighted line at the 
  373.             
  374.             top showing the commands accessible from that screen.  These 
  375.             
  376.             are the commands used to access the menus and enter re-
  377.             
  378.             sponses during document preparation.  The following is a 
  379.             
  380.             summary of these commands:
  381.             
  382.                  TEXT SELECTION screen:
  383.             
  384.                  - (N)ext - to proceed to the next text menu.
  385.                  - (P)revious - to return to a previous text menu.
  386.                  - (ESC)Master Menu - to return to the MASTER MENU.
  387.             
  388.             
  389.                  INPUT VARIABLES screen:
  390.             
  391.                  - (CTRL-R)edo - to correct a multiple-line response.
  392.                  - (CR)Left Mrgn - to begin response at left margin.
  393.                  - (ESC)Menu - to return to the Current Text Menu.
  394.                  - (>)Center - to center the response on the page.
  395.                  - (?)Help - to display help for the variable response.
  396.             
  397.             NOTE: The user may skip a response by entering 2 <RETURN>s.
  398.             
  399.                  REVISED TEXT screen:
  400.             
  401.                  - (R)eject text - to reject revised text & not store 
  402.                                    responses.
  403.                  - <RETURN>      - to accept the revised text and append 
  404.                                    to document.
  405.             
  406.             At any time during document preparation the user may return 
  407.             
  408.             to the Master Menu screen by entering <ESCAPE> one, or more, 
  409.             
  410.             times.  From that screen the user may view the general 
  411.             
  412.             program help file or the Text Selection Index, skip to a 
  413.  
  414.  
  415.                                        - 5 -
  416.  
  417.  
  418.             
  419.             menu, display the document being prepared, change to double-
  420.             
  421.             line or single-line spacing or change to a different forms 
  422.             
  423.             library.  The latter feature permits the user to begin a 
  424.             
  425.             letter in the library containing forms of address for digni-
  426.             
  427.             taries (LTRADR) and, after entering the address information 
  428.             
  429.             shift over to one of the other letter libraries to complete 
  430.             
  431.             the letter.
  432.             
  433.             
  434.             
  435.             This concludes the summary of PC-FORMS' features.  The 
  436.             
  437.             remainder of this manual consists of detailed instructions 
  438.             
  439.             for the use of PC-FORMS users who want more information 
  440.             
  441.             about how the program works.
  442.             
  443.             
  444.             
  445.                                  PC-FORMS START-UP
  446.             
  447.             PC-FORMS is started by entering PCFM at the DOS prompt.  You 
  448.             
  449.             may also enter the form name, the output file specification 
  450.             
  451.             and a mode character D, N or R for Document, Non-Document or 
  452.             
  453.             Right-Justified output.  You will appreciate the ability to 
  454.             
  455.             start the programs with a one-line command containing all of 
  456.             
  457.             the required start-up information after becoming familiar 
  458.             
  459.             with them.
  460.             
  461.             
  462.             
  463.             When the program is started with the "PCFM" command, the 
  464.             
  465.             program displays a sorted list of the forms libraries avail-
  466.             
  467.             able in the current working directory.  A description of the 
  468.             
  469.             forms is available in the general help file which is dis-
  470.             
  471.             played by entering "PCFM" at the DOS prompt and a question 
  472.             
  473.  
  474.  
  475.                                        - 6 -
  476.  
  477.  
  478.             mark when the following prompt appears:
  479.             
  480.                       Enter Form Name (? for help) ->
  481.             
  482.             
  483.             
  484.             Examples of correct start-up entries at the DOS prompt for 
  485.             
  486.             the PC-FORMS program are:
  487.             
  488.                       C>pcfm
  489.                       C>pcfm wills
  490.                       C>pcfm wills testwill.doc
  491.                       C>pcfm wills testwill.doc d
  492.             
  493.             
  494.             The program will request input of any of the above informa-
  495.             
  496.             tion not supplied on the command line.  The first menu the 
  497.             
  498.             program looks for is <FORM>01.LEX, where <FORM> is the form 
  499.             
  500.             name.  As text selections are made, it proceeds through the 
  501.             
  502.             series of text menus as directed by the user.
  503.             
  504.             
  505.             
  506.             If the file name entered for the document already exists you 
  507.             
  508.             will be advised of that fact and asked if you want to over-
  509.             
  510.             write it or append your text selections to the end of it.  A 
  511.             
  512.             (N)o answer to this query will allow you to rename the 
  513.             
  514.             proposed document.
  515.             
  516.             
  517.             
  518.             The program maintains a list of the proof files for each 
  519.             
  520.             forms library which have not been deleted from the disk in a 
  521.             
  522.             file named with the form name plus the suffix ".VRS".  When 
  523.             
  524.             a forms library is selected for which proof files exist the 
  525.             
  526.             user is asked whether he, or she, wants to load the previous 
  527.             
  528.             variable responses from one of those proof files.  If so, 
  529.             
  530.             the program displays a list of the proof files created using 
  531.             
  532.             that library and prompts the user for the one to load.
  533.  
  534.  
  535.                                        - 7 -
  536.  
  537.  
  538.             
  539.             
  540.             
  541.             This makes it unnecessary to re-enter variable responses for 
  542.             
  543.             a series of forms in which the same responses apply.  This 
  544.             
  545.             feature is especially helpful in connection with pleadings 
  546.             
  547.             and related documents in which the parties' names and other 
  548.             
  549.             information does not change.  It is also useful for doing 
  550.             
  551.             different versions of a document for comparison purposes.
  552.             
  553.             
  554.             
  555.             Text selections are made from screen displays of the Text 
  556.             
  557.             Menus or from the Text Selection Indexes.  After inserting 
  558.             
  559.             variable responses in the selected text it is revised and 
  560.             
  561.             displayed.  The user is permitted to either reject the re-
  562.             
  563.             vised text or append it to the output document.
  564.             
  565.             
  566.             
  567.                                 PC-FORMS MASTER MENU
  568.             
  569.             After the PC-FORMS program is started and the preliminary 
  570.             
  571.             entries are completed the following Master Menu appears:
  572.             
  573.                       1.  Text Menu (to Start or Continue Document)
  574.             
  575.                       2.  Help, Order or Setup Menu
  576.             
  577.                       3.  Text Selection Indexes (to Find Text)
  578.             
  579.                       4.  Go to a Text Menu (to Skip to a Menu)
  580.             
  581.                       5.  Display Document (to See Document)
  582.             
  583.                       6.  Line Spacing Toggle = SINGLE
  584.             
  585.                       7.  Change from <FORMNAME> to Another Library
  586.             
  587.                       8.  Quit - Exit Unfinished Document
  588.             
  589.                       9.  Quit - Exit to Word Processor
  590.             
  591.             A highlighted MASTER MENU heading is displayed at the top of 
  592.             
  593.  
  594.  
  595.                                        - 8 -
  596.  
  597.  
  598.             your screen showing the name of the form you have selected 
  599.             
  600.             and the current text file.  This heading also shows the 
  601.             
  602.             version of the program you are running and the copyright 
  603.             
  604.             notice.
  605.             
  606.             
  607.             
  608.             Selection 6 on this menu lets you toggle back and forth 
  609.             
  610.             between single and double-line spacing for the document 
  611.             
  612.             being prepared.
  613.             
  614.             
  615.             
  616.             Selection 7 lets you change to a different forms library and 
  617.             
  618.             continue the assembly of your document.  For example, this 
  619.             
  620.             feature permits the user to begin a letter using the special 
  621.             
  622.             'forms of address' letter library called LTRADR and then 
  623.             
  624.             switch to another letter library to complete the letter 
  625.             
  626.             being assembled.
  627.             
  628.             
  629.             
  630.             Normally, you will select the first Text Menu.  Before doing 
  631.             
  632.             so you may wish to review the General Program Help screens 
  633.             
  634.             or the Text Indexes.  After these selections you can return 
  635.             
  636.             to the Master Menu by entering <ESCAPE>.
  637.             
  638.             
  639.             
  640.             You can access the text selections in a Forms Library either 
  641.             
  642.             from the Text Selection Screen showing the current Text Menu 
  643.             
  644.             or from the Text Selection Index.  Text selections may be 
  645.             
  646.             reviewed by selecting them and then returning to the current 
  647.             
  648.             Text Menu by pressing <ESCAPE>.
  649.             
  650.                                           
  651.             
  652.                                      TEXT MENU
  653.  
  654.  
  655.                                        - 9 -
  656.  
  657.  
  658.             
  659.             When you select the Text Menu, the following screen heading 
  660.             
  661.             line will appear:
  662.             
  663.             "TEXT SELECTION -(N)ext -(P)revious -(ESC)Master Menu -Text 
  664.             Menu: 
  665.                 Text Selections for Library: <form>, Menu No.  n -"
  666.             
  667.             
  668.             This will be followed by a display of the text selections in 
  669.             
  670.             the current menu.  This menu describes one or more sections 
  671.             
  672.             of text which may be added to the output document.
  673.             
  674.             
  675.             
  676.             Pressing <ESCAPE> will return you to the Master Menu.  An N 
  677.             
  678.             will select the next Text Menu, a P will select the previous 
  679.             
  680.             one.
  681.             
  682.             
  683.             
  684.             The screen heading includes reminders of these commands for 
  685.             
  686.             the user's convenience.
  687.             
  688.             
  689.             
  690.             After making your text selections from this menu, enter an N 
  691.             
  692.             to continue to the next Text Menu.  Continue this procedure 
  693.             
  694.             until your document is finished.
  695.             
  696.             
  697.             
  698.             At any time you may <ESCAPE> to the Master Menu and display 
  699.             
  700.             the document, switch to double spacing, change to another 
  701.             
  702.             form or review the Text Selection Indexes.  After you have 
  703.             
  704.             become familiar with a particular forms library you may 
  705.             
  706.             return to the Master Menu to skip over menus from which no 
  707.             
  708.             text is to be selected by using Option No.  4, - "Go to a 
  709.             
  710.             Text Menu".
  711.             
  712.                                VARIABLE INPUT SCREEN
  713.  
  714.  
  715.                                        - 10 -
  716.  
  717.  
  718.             
  719.             When you have entered your text selection, the text will be 
  720.             
  721.             displayed with its variable names under a heading, as fol-
  722.             
  723.             lows:
  724.             
  725.             "VARIABLE INPUT -(CTRL-R)edo -(CR)Left Mrgn -(ESC)Menu 
  726.             
  727.             -(>)Center -(?)Help"
  728.             
  729.             If the text contains variable names you will be prompted to 
  730.             
  731.             enter the information you want to replace them in the bottom 
  732.             
  733.             window of the screen.  If there is more than a full window 
  734.             
  735.             of text the program will show the following line at the 
  736.             
  737.             bottom of the window:
  738.             
  739.             "- more -"
  740.             
  741.             The program will wait for you to press a key to continue.  
  742.             
  743.             When a key is pressed the text will scroll up on the screen.
  744.             
  745.             
  746.             
  747.             If the characters '->' appear after the variable prompt the 
  748.             
  749.             program has entered the '>' character for you so that your 
  750.             
  751.             entry will be centered on the page.  This occurs when the 
  752.             
  753.             variable name in the text begins with the '>' character.  
  754.             
  755.             The '(>)Center' in the screen heading is a reminder that if 
  756.             
  757.             you want to center your response you, or the program, must 
  758.             
  759.             enter the '>' character before entering the response.
  760.             
  761.             
  762.             
  763.             If your response goes beyond the end of the format line the 
  764.             
  765.             program will wrap your entry to the next line automatically, 
  766.             
  767.             after the next space or hyphen.  If you find that you have 
  768.             
  769.             made a mistake in a previous line you may re-enter your 
  770.             
  771.             response by entering a CTRL-R character at any time prior to 
  772.             
  773.  
  774.  
  775.                                        - 11 -
  776.  
  777.  
  778.             your carriage return as indicated by the (CTRL-R)e-do in the 
  779.             
  780.             screen heading.  If your mistake is on the current line you 
  781.             
  782.             may simply back space to it and re-enter from there.
  783.             
  784.             
  785.             
  786.             (CR)Left Mrgn in the screen heading is a reminder that you 
  787.             
  788.             may begin your response at the left margin of the screen by 
  789.             
  790.             first entering a carriage return.  This may be necessary for 
  791.             
  792.             responses which will occupy an entire line in your output 
  793.             
  794.             document.  (For Example: {AGENT_LINE} in the CORPN library)
  795.             
  796.             
  797.             
  798.             If you decide you do not want to include a particular sec-
  799.             
  800.             tion of text or if you find you have made a mistake in a 
  801.             
  802.             previous entry you may return to the Text Menu by pressing 
  803.             
  804.             <ESCAPE>.  Pressing it twice will return you to the Master 
  805.             
  806.             Menu.  At any time during variable input you may cancel your 
  807.             
  808.             entries and return to the Text Menu by pressing <ESCAPE>.
  809.             
  810.             
  811.             
  812.             "(?)Help" is a reminder that entry of a question mark at a 
  813.             
  814.             variable prompt will result in the display of the help 
  815.             
  816.             message for that variable.
  817.             
  818.             
  819.             
  820.             The prompts for the variable names in the selected text for 
  821.             
  822.             which responses have not been stored in memory will appear 
  823.             
  824.             in sequence.  When all responses have been entered the text 
  825.             
  826.             will be revised and displayed for your acceptance or rejec-
  827.             
  828.             tion.
  829.             
  830.             
  831.             
  832.             You can enter two returns (<RETURN><RETURN>) at a variable 
  833.  
  834.  
  835.                                        - 12 -
  836.  
  837.  
  838.             
  839.             prompt to skip over a variable name for which you want no 
  840.             
  841.             response to appear in the final document (such as an extra 
  842.             
  843.             address line in a form letter).
  844.             
  845.             
  846.             
  847.                                 REVISED TEXT SCREEN
  848.             
  849.             The heading for the revised text screen is an inverse video 
  850.             
  851.             display followed by the current format line, as follows:
  852.             
  853.                "REVISED TEXT -(R)eject -(Return)Append to Document"
  854.             
  855.             After the revised text is displayed the program will wait 
  856.             
  857.             for you to enter an 'R' to reject it or a Carriage Return to 
  858.             
  859.             add it to the output file.  When a section of text is re-
  860.             
  861.             jected the responses for global variables entered for that 
  862.             
  863.             section of text are deleted.  When a section is added to the 
  864.             
  865.             document that text selection and the responses for any local 
  866.             
  867.             variables in it is saved in a 'proof' file named <form-
  868.             
  869.             name>.PRF.
  870.             
  871.             
  872.             
  873.             If it becomes necessary to leave the program in the middle 
  874.             
  875.             of a job, you may come back to it later and begin where you 
  876.             
  877.             left off.  If you load the variable responses in the proof 
  878.             
  879.             file for the form it is unnecessary to re-enter that infor-
  880.             
  881.             mation.
  882.             
  883.             
  884.             
  885.                                     OUTPUT MODES
  886.             
  887.             Three output modes are available: Document, Non-Document and 
  888.             
  889.             Right-Justified.  Document mode text is revised to permit 
  890.             
  891.             printing it right justified using micro-justification with 
  892.             
  893.  
  894.  
  895.                                        - 13 -
  896.  
  897.  
  898.             the WordStar or WordPerfect word processing program.  Docu-
  899.             
  900.             ment mode output files are in WordStar format.  They are 
  901.             
  902.             converted to WordPerfect format using the CONVERT program or 
  903.             
  904.             to Microsoft Word format using the WS_RTF program when 
  905.             
  906.             linked to one of those word processors.
  907.             
  908.             
  909.             
  910.             In Non-Document mode the program revises each line of text 
  911.             
  912.             by removing one of any duplicate spaces between words and 
  913.             
  914.             all but two spaces after each punctuation mark.  Each line 
  915.             
  916.             of text is then terminated at the last space or hyphen 
  917.             
  918.             before the right margin marker in the current format line.  
  919.             
  920.             This results in the text having a ragged right margin with-
  921.             
  922.             out extra spaces.
  923.             
  924.             
  925.             
  926.             In Right-Justified mode the output is revised by inserting 
  927.             
  928.             extra spaces to permit printing it right-justified on print-
  929.             
  930.             ers which do not support micro-justification.
  931.             
  932.             
  933.             
  934.             In Document mode the output files contain special non-
  935.             
  936.             printing characters used by WordStar to right-justify the 
  937.             
  938.             text.  They also contain special dot-command lines which are 
  939.             
  940.             used to format the printed documents.
  941.             
  942.             
  943.             
  944.             The output files in both Non-Document and Right-Justified 
  945.             
  946.             mode will contain only printable ASCII characters without 
  947.             
  948.             special formatting characters or dot commands.
  949.             
  950.             
  951.             
  952.             If your printer does not support micro-justification or you 
  953.  
  954.  
  955.                                        - 14 -
  956.  
  957.  
  958.             
  959.             do not use WordStar, Word or WordPerfect for document print-
  960.             
  961.             ing you will want to output non-document or right-justified 
  962.             
  963.             documents.
  964.             
  965.             
  966.             
  967.                                    VARIABLE FILES
  968.             
  969.             There is one variable file for each forms library.  This 
  970.             
  971.             file is named with the formname followed by the suffix 
  972.             
  973.             ".VBL".  The file contains a section of variable prompts 
  974.             
  975.             headed by the dot command ".QN", a section of variable help 
  976.             
  977.             messages headed by the dot command ".HP" and a section of 
  978.             
  979.             the text heading lines in numeric and alphabetical sequence 
  980.             
  981.             headed by the dot command .IX.
  982.             
  983.             
  984.             
  985.             Each prompt and help message is entered in this file on the 
  986.             
  987.             line immediately after the line containing the variable name 
  988.             
  989.             in curly braces.
  990.             
  991.             
  992.             
  993.             The help sections of variable files contain brief statements 
  994.             
  995.             for each variable name explaining what data should be en-
  996.             
  997.             tered in response to the prompt for that variable.  These 
  998.             
  999.             messages must also be entered in the file on the line imme-
  1000.             
  1001.             diately following a line containing the variable name in 
  1002.             
  1003.             curly braces.  The variable help messages are not required 
  1004.             
  1005.             for the program to run properly.  If there is no help mes-
  1006.             
  1007.             sage for a variable name the user will be advised of that 
  1008.             
  1009.             fact if help is requested for it.
  1010.             
  1011.             
  1012.             
  1013.  
  1014.  
  1015.                                        - 15 -
  1016.  
  1017.  
  1018.             The last entry in the help section of these files is a Li-
  1019.             
  1020.             brary Code Number under the variable name {~LIB_#}.  This 
  1021.             
  1022.             Code Number tells the program what screen colors to use for 
  1023.             
  1024.             that library and provides a rate for calculating the esti-
  1025.             
  1026.             mated document value for value billing purposes.  This 
  1027.             
  1028.             number can be changed by the user.
  1029.             
  1030.             
  1031.             
  1032.             A copyright notice for a forms library can be displayed by 
  1033.             
  1034.             including that notice in the help section of the variable 
  1035.             
  1036.             file under the variable name {~COPYRIGHT}.
  1037.             
  1038.             
  1039.             
  1040.                            COLOR and VALUE BILLING CODES
  1041.             
  1042.             The table below shows the Screen Border Color Codes.  This 
  1043.             
  1044.             code is selected from the Setup Menu.
  1045.             
  1046.             
  1047.                            COLOR TABLE FOR BORDER COLOR:
  1048.             
  1049.                       0 =  Black          8 =  Grey
  1050.                       1 =  Blue           9 =  Light Blue
  1051.                       2 =  Green          A =  Light Green
  1052.                       3 =  Cyan           B =  Light Cyan
  1053.                       4 =  Red            C =  Light Red
  1054.                       5 =  Magenta        D =  Light Magenta
  1055.                       6 =  Brown          E =  Yellow
  1056.                       7 =  White          F =  Bright White
  1057.             
  1058.             The tables below show the Background and Foreground colors 
  1059.             
  1060.             for the heading and normal and highlighted text which are 
  1061.             
  1062.             selected using the Setup Menu.
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.                                        - 16 -
  1076.  
  1077.  
  1078.                             COLOR TABLES FOR BACKGROUND
  1079.             
  1080.                                AND FOREGROUND COLORS:
  1081.             
  1082.             
  1083.                         First HEX Digit = Background Color:
  1084.             
  1085.                       0 =  Black          8 =  Black Blinking
  1086.                       1 =  Blue           9 =  Blue Blinking
  1087.                       2 =  Green          A =  Green Blinking
  1088.                       3 =  Cyan           B =  Cyan Blinking
  1089.                       4 =  Red            C =  Red Blinking
  1090.                       5 =  Magenta        D =  Magenta Blinking
  1091.                       6 =  Brown          E =  Yellow Blinking
  1092.                       7 =  White          F =  White Blinking
  1093.             
  1094.                              Second HEX Digit = Foreground Color:
  1095.             
  1096.                       0 =  Black          8 =  Gray
  1097.                       1 =  Blue           9 =  Light Blue
  1098.                       2 =  Green          A =  Light Green
  1099.                       3 =  Cyan           B =  Light Cyan
  1100.                       4 =  Red            C =  Light Red
  1101.                       5 =  Magenta        D =  Light Magenta
  1102.                       6 =  Brown          E =  Yellow
  1103.                       7 =  White          F =  Bright White
  1104.             
  1105.             
  1106.                                  SOURCE TEXT RULES
  1107.             
  1108.             The following are the rules which must be followed in the 
  1109.             
  1110.             preparation of the source text section of text files:
  1111.             
  1112.             
  1113.              1.  ASCII CHARACTERS.  The text must be in ASCII charac-
  1114.             
  1115.                  ters.
  1116.             
  1117.             
  1118.             
  1119.              2.  PARAGRAPH TERMINATION.  Paragraphs and lines which 
  1120.             
  1121.                  stand alone, such as formatting lines, MUST BE TERMI-
  1122.             
  1123.                  NATED WITH A CARRIAGE RETURN IMMEDIATELY FOLLOWING THE 
  1124.             
  1125.                  LAST CHARACTER OR PUNCTUATION MARK.
  1126.             
  1127.             
  1128.             
  1129.              3.  LINE TERMINATION.  EACH OF THE LINES WITHIN A PARA-
  1130.             
  1131.                  GRAPH, OTHER THAN THE LAST ONE, MUST END WITH A SPACE 
  1132.             
  1133.  
  1134.  
  1135.                                        - 17 -
  1136.  
  1137.  
  1138.                  BEFORE THE CARRIAGE RETURN.
  1139.             
  1140.             
  1141.             
  1142.              4.  TEXT ARRANGEMENT.  The text within a paragraph may be 
  1143.             
  1144.                  arranged for display right-justified by the insertion 
  1145.             
  1146.                  of not more than one extra space between words and an 
  1147.             
  1148.                  unlimited number after any period, colon, exclamation 
  1149.             
  1150.                  mark or question mark.  These extra spaces are removed 
  1151.             
  1152.                  by the revision process.
  1153.             
  1154.             
  1155.             
  1156.              5.  VARIABLE NAMES.  Variable names must be enclosed in 
  1157.             
  1158.                  curly braces and must not exceed 23 characters in 
  1159.             
  1160.                  length, including the curly braces.  There are two 
  1161.             
  1162.                  major types of variable names, GLOBAL and LOCAL, which 
  1163.             
  1164.                  are distiguished by whether the first character after 
  1165.             
  1166.                  the initial curly brace is alphanumeric.  GLOBAL varia-
  1167.             
  1168.                  ble names begin with an alphanumeric character.
  1169.             
  1170.             
  1171.             
  1172.              6.  VARIABLE RESPONSE TREATMENT.  The responses for GLOBAL 
  1173.             
  1174.                  variables are automatically substituted for those 
  1175.             
  1176.                  variable names in all later sections of text selected 
  1177.             
  1178.                  for the document.  The responses for all LOCAL varia-
  1179.             
  1180.                  bles other than those beginning with a question mark or 
  1181.             
  1182.                  tilde will be displayed when the name is encountered in 
  1183.             
  1184.                  later sections of text and the user given an opportuni-
  1185.             
  1186.                  ty to change it for that section of text.  The user 
  1187.             
  1188.                  will always be prompted for a response if the variable 
  1189.             
  1190.                  name begins with a question mark.
  1191.             
  1192.              
  1193.  
  1194.  
  1195.                                        - 18 -
  1196.  
  1197.  
  1198.             
  1199.              7.  SPECIAL AND LOCAL VARIABLE USAGE.  The following is a 
  1200.             
  1201.                  summary of how SPECIAL and LOCAL variables are used in 
  1202.             
  1203.                  text libraries:
  1204.             
  1205.             
  1206.             
  1207.                  The latest responses for the following five SPECIAL 
  1208.             
  1209.                  variables are saved in  the proof file of the Document 
  1210.             
  1211.                  being assembled.  These variable names are  used for 
  1212.             
  1213.                  the following purposes:
  1214.             
  1215.                     1st               SPECIAL Variable 
  1216.                     Char              Program Response
  1217.                      >  - Automatically inserts a ">" character to 
  1218.                           center the user response.  (Indicated by -> on 
  1219.                           the variable input screen)
  1220.             
  1221.                      ~  - Displays a 'Standard Response' for the Varia-
  1222.                           ble Name and permits the user to retain it or 
  1223.                           change it.
  1224.             
  1225.                 0 or |  - Adjusts the number of spaces after the 
  1226.                           variable response to keep additional 
  1227.                           information on the same line in the same 
  1228.                           relative position as it was in the text 
  1229.                           library file.
  1230.             
  1231.                      &  - Displays the user's previous response to the 
  1232.                           Variable Prompt, if any, and permits the user 
  1233.                           to retain it or change it.
  1234.             
  1235.                  REGULAR LOCAL variable names are used in sections of 
  1236.             
  1237.                  text where the response usually will not be repeated in 
  1238.             
  1239.                  later sections of text.  The responses to these varia-
  1240.             
  1241.                  ble names are NOT SAVED in the proof file of the docu-
  1242.             
  1243.                  ment being assembled and are used, as follows:
  1244.             
  1245.             
  1246.             
  1247.                     1st             REGULAR LOCAL Variable 
  1248.                     Char              Program Response
  1249.                      ?  - Always displays the prompt for the Variable 
  1250.                           Name, since the previous response was not 
  1251.                           stored.
  1252.             
  1253.  
  1254.  
  1255.                                        - 19 -
  1256.  
  1257.  
  1258.                      !  - Displays the user's previous respones to the 
  1259.                           Variable Prompt, if any, and permits the user 
  1260.                           to retain it or change it.
  1261.             
  1262.                  For the "!" character you can substitute any non-
  1263.             
  1264.                  alphanumeric character other than one of those listed 
  1265.             
  1266.                  above.
  1267.             
  1268.             
  1269.             
  1270.              8.  SPECIAL GLOBAL VARIABLE.  There is one special GLOBAL 
  1271.             
  1272.                  variable name available which is begun with the zero 
  1273.             
  1274.                  '0' character after the first curly brace.  It is used 
  1275.             
  1276.                  to adjust the spaces after the variable response in the 
  1277.             
  1278.                  same way as the SPECIAL LOCAL variable beginning with 
  1279.             
  1280.                  the vertical bar '|'.
  1281.             
  1282.             
  1283.             
  1284.              9.  OTHER WORDSTAR DOT COMMANDS.  Other dot commands may 
  1285.             
  1286.                  appear in the format section of the file or in a text 
  1287.             
  1288.                  section.  Dot commands may not appear within a para-
  1289.             
  1290.                  graph of text since, if placed there, they will be 
  1291.             
  1292.                  merged with the text when it is revised.
  1293.             
  1294.             
  1295.             
  1296.             10.  FORMAT COMMAND LINE.  The .FT dot command, as explained 
  1297.             
  1298.                  above, is used in text libraries to establish the 
  1299.             
  1300.                  format of the following text.  The characters which may 
  1301.             
  1302.                  be used in a format command line are shown below:
  1303.             
  1304.                  Permissable format line characters follow:
  1305.             
  1306.                       L = Left Margin
  1307.                       P = Paragraph Margin
  1308.                       ! = Ordinary Tab Stop
  1309.                       # = Decimal Tab Stop
  1310.                       R = Right Margin (also a Tab Stop)
  1311.                       - = Spacing (Fill) Characters
  1312.             
  1313.  
  1314.  
  1315.                                        - 20 -
  1316.  
  1317.  
  1318.             If your word processor supports hanging indents, as the 
  1319.             
  1320.             latest versions of WordStar do, you can use the paragraph 
  1321.             
  1322.             margin to begin the first line of each paragraph to the left 
  1323.             
  1324.             of the left margin, leaving the paragraph number in the 
  1325.             
  1326.             margin.  You must remember to re-configure the word proces-
  1327.             
  1328.             sor for this style of paragraphs before revising the docu-
  1329.             
  1330.             ment with it.
  1331.             
  1332.             
  1333.             
  1334.             The numbered paragraphs above are examples of text done with 
  1335.             
  1336.             hanging indents.
  1337.             
  1338.             
  1339.             
  1340.             Sections of repeatable text (such as gifts of personal 
  1341.             
  1342.             property in the wills library) will contain only LOCAL 
  1343.             
  1344.             variable names for which the responses can be changed each 
  1345.             
  1346.             time the text is appended to the document.
  1347.             
  1348.             
  1349.             
  1350.             
  1351.             
  1352.                                  PC-LIBRARY PROGRAM
  1353.             
  1354.             The PC-LIBRARY program may be used to create and update the 
  1355.             
  1356.             variable file for a forms library after the numbered text 
  1357.             
  1358.             sections have been entered in a series of .LEX files.  That 
  1359.             
  1360.             program will ask the user to enter the prompt for variable 
  1361.             
  1362.             names in the text files for which no prompt is found in the 
  1363.             
  1364.             variable file.  It will also save the text headings in 
  1365.             
  1366.             numeric and alphabetical sequence and, when requested, will 
  1367.             
  1368.             update the variable file for a library.  See the manual for 
  1369.             
  1370.             that program for an explanation of its operation.
  1371.             
  1372.             
  1373.  
  1374.  
  1375.                                        - 21 -
  1376.  
  1377.  
  1378.             
  1379.             This program also generates files for printing the Text 
  1380.             
  1381.             Indexes, the Text Library, the Variable Prompts and Variable 
  1382.             
  1383.             Help messages in a PC-FORMS variable file.  The program is 
  1384.             
  1385.             very useful for those who wish to develop their own Forms 
  1386.             
  1387.             Libraries.
  1388.             
  1389.             
  1390.             
  1391.                                         ###
  1392.             
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.                                        - 22 -
  1436.  
  1437.  
  1438.             
  1439.                 INDEX TO PC-FORMS USERS' MANUAL
  1440.             
  1441.             Acceptance of Revised Text, 13
  1442.             Accessing Text Selections, 9
  1443.             Appending Revised Text to Document, 8
  1444.             Appending to a Document File, 7
  1445.             Arranging Text for Display, 19
  1446.             
  1447.             Changing Libraries, 6
  1448.             Changing to a Different Library, 9
  1449.             Characters in Text Library Files, 18
  1450.             Commands
  1451.               Accessible, 5
  1452.             Command-Line Entries, 6
  1453.             Control-R to Redo an Entry, 12
  1454.             Conversion to WordPerfect, 14
  1455.             Copyright Notice, 16
  1456.             
  1457.             Description of Forms, 7
  1458.             Description of Libraries, 3
  1459.             Document File
  1460.               Naming, 3
  1461.             Document Mode Output, 14
  1462.             Dot Commands in Text Files, 21
  1463.             Double-Line Spacing, 6
  1464.             
  1465.             Escaping to the Master Menu, 10
  1466.             Exiting the Help Screen, 3
  1467.             Extra Spaces in Text Selections, 19
  1468.             
  1469.             Form Library files, 2
  1470.             Format Command Line, 21
  1471.             Forms
  1472.               Description of, 7
  1473.             Full Window of Text, 11
  1474.             
  1475.             Help File, 7
  1476.             Help Message File, 2
  1477.             Help Messages
  1478.               Variable, 15
  1479.             
  1480.             Leaving Program, 13
  1481.             Library Code Number, 16
  1482.             Line Spacing Toggle, 9
  1483.             Linking to Word Processor, 2
  1484.             List of Libraries, 7
  1485.             List of Proof Files, 7
  1486.             Loading Previous Responses, 8
  1487.             Loading Responses from Previous File, 13
  1488.             Loading Variable Responses from Previous File, 4
  1489.             
  1490.             Making Text Selections, 5
  1491.             Master Menu, 8
  1492.             Master Screen
  1493.  
  1494.  
  1495.                                        - 23 -
  1496.  
  1497.  
  1498.               Returning to, 6
  1499.             Menu Screens, 4
  1500.             
  1501.             Non-Document Mode Output, 14, 15
  1502.             
  1503.             Output Modes, 14
  1504.             OVERVIEW, 1
  1505.             Overwriting a Document File, 7
  1506.             
  1507.             PC-FORMS Program, 1
  1508.             PC-LIBRARY Program, 2, 22
  1509.             Prompts for Variable Names, 12
  1510.             Proof File, 1, 13
  1511.             Proof File for Document, 3
  1512.             
  1513.             Rejecting Revised Text, 8
  1514.             Rejection of Revised Text, 13
  1515.             Renaming the Document File, 7
  1516.             Response
  1517.               Beginning at Left Margin, 12
  1518.             Returning to Master Menu, 9
  1519.             Returning to Text Menu, 12
  1520.             Returning to the Current Text Menu, 10
  1521.             Revised Text
  1522.               Acceptance, 13
  1523.               Rejection, 13
  1524.             Revised Text Screen Commands, 13
  1525.             Right-Justified Mode Output, 14, 15
  1526.             
  1527.             Screen Colors, 16
  1528.             Single-Line Spacing, 6
  1529.             Skipping to a Text Menu, 11
  1530.             Starting PC-FORMS, 2
  1531.             Starting the Program, 6
  1532.             Start-Up Entries, 7
  1533.             
  1534.             Terminating Lines within Paragraphs, 18
  1535.             Terminating Paragraphs, 18
  1536.             Text Centering Characters ->, 11
  1537.             Text Entries Wrapped to Next Line, 12
  1538.             Text Heading Lines Index, 15
  1539.             Text Menus, 7
  1540.             Text Selection Menu Commands, 10
  1541.             Text Selections, 8
  1542.             Two Returns to Skip an Entry, 13
  1543.             
  1544.             Use of Hanging Indentation, 21
  1545.             Use of ? for Help, 12
  1546.             
  1547.             Value Billing Code, 16
  1548.             Variable Files, 15
  1549.             Variable Help Messages, 15
  1550.             Variable Input Commands, 11
  1551.             Variable Names, 19
  1552.             Variable Responses
  1553.  
  1554.  
  1555.                                        - 24 -
  1556.  
  1557.  
  1558.               Treatment of, 19
  1559.             Variables
  1560.               Global, 19
  1561.               Regular Local, 20
  1562.               Special Local, 20
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.                                        - 25 -
  1616.